module Term::ANSIColor

The ANSIColor module can be used for namespacing and mixed into your own classes.

Constants

COLORED_REGEXP

Regular expression that is used to scan for ANSI-Attributes while uncoloring strings.

VERSION

Term::ANSIColor version

Public Class Methods

attributes()
coloring=(val) click to toggle source

Turns the coloring on or off globally, so you can easily do this for example:

Term::ANSIColor::coloring = STDOUT.isatty
# File lib/term/ansicolor.rb, line 48
def self.coloring=(val)
  @coloring = !!val
end
coloring?() click to toggle source

Returns true, if the coloring function of this module is switched on, false otherwise.

# File lib/term/ansicolor.rb, line 41
def self.coloring?
  @coloring
end
create_color_method(color_name, color_value) click to toggle source
# File lib/term/ansicolor.rb, line 67
    def self.create_color_method(color_name, color_value)
      module_eval <<-EOT
        def #{color_name}(string = nil, &block)
          color(:#{color_name}, string, &block)
        end
      EOT
      self
    end
term_ansicolor_attributes() click to toggle source

Returns an array of all Term::ANSIColor attributes as symbols.

# File lib/term/ansicolor.rb, line 129
def term_ansicolor_attributes
  ::Term::ANSIColor::ATTRIBUTE_NAMES
end
Also aliased as: attributes
true_coloring=(val) click to toggle source

Turns the true coloring mode on or off globally, that will display 24-bit colors if your terminal supports it:

Term::ANSIColor::true_coloring = ENV['COLORTERM'] =~ /\A(truecolor|24bit)\z/
# File lib/term/ansicolor.rb, line 62
def self.true_coloring=(val)
  @true_coloring = !!val
end
true_coloring?() click to toggle source

Returns true, if the tue coloring mode of this module is switched on, false otherwise.

# File lib/term/ansicolor.rb, line 55
def self.true_coloring?
  @true_coloring
end

Public Instance Methods

attributes()
color(name, string = nil) { || ... } click to toggle source

Return string or the result string of the given block colored with color name. If string isn't a string only the escape sequence to switch on the color name is returned.

# File lib/term/ansicolor.rb, line 103
def color(name, string = nil, &block)
  attribute = Attribute[name] or raise ArgumentError, "unknown attribute #{name.inspect}"
  result = ''
  result << "\e[#{attribute.code}m" if Term::ANSIColor.coloring?
  if block_given?
    result << yield.to_s
  elsif string.respond_to?(:to_str)
    result << string.to_str
  elsif respond_to?(:to_str)
    result << to_str
  else
    return result # only switch on
  end
  result << "\e[0m" if Term::ANSIColor.coloring?
  result.extend(Term::ANSIColor)
end
on_color(name, string = nil, &block) click to toggle source
# File lib/term/ansicolor.rb, line 120
def on_color(name, string = nil, &block)
  attribute = Attribute[name] or raise ArgumentError, "unknown attribute #{name.inspect}"
  attribute = attribute.dup
  attribute.background = true
  color(attribute, string, &block)
end
support?(feature) click to toggle source

Returns true if Term::ANSIColor supports the feature.

The feature :clear, that is mixing the clear color attribute into String, is only supported on ruby implementations, that do not already implement the String#clear method. It's better to use the reset color attribute instead.

# File lib/term/ansicolor.rb, line 32
def support?(feature)
  case feature
  when :clear
    !String.instance_methods(false).map(&:to_sym).include?(:clear)
  end
end
term_ansicolor_attributes() click to toggle source

Returns an array of all Term::ANSIColor attributes as symbols.

# File lib/term/ansicolor.rb, line 137
def  term_ansicolor_attributes
  ::Term::ANSIColor.term_ansicolor_attributes
end
Also aliased as: attributes
uncolor(string = nil) { || ... } click to toggle source

Returns an uncolored version of the string, that is all ANSI-Attributes are stripped from the string.

# File lib/term/ansicolor.rb, line 86
def uncolor(string = nil) # :yields:
  if block_given?
    yield.to_str.gsub(COLORED_REGEXP, '')
  elsif string.respond_to?(:to_str)
    string.to_str.gsub(COLORED_REGEXP, '')
  elsif respond_to?(:to_str)
    to_str.gsub(COLORED_REGEXP, '')
  else
    ''
  end.extend(Term::ANSIColor)
end
Also aliased as: uncolored
uncolored(string = nil)
Alias for: uncolor